home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d26 / qmtek601.arc / APISTART.TEC < prev    next >
Text File  |  1991-05-23  |  3KB  |  99 lines
  1. ID:AP Starting DESQview Under API
  2. Quarterdeck Technical Note #135
  3. by Stan Young
  4.  
  5.           Starting DESQview Under API Program Control
  6.  
  7.    Many API programs are designed to run in much the same as any
  8. off-the-shelf program in the DESQview environment.  That is, the
  9. user
  10. simply selects the program from the Open Window menu, it opens and
  11. once
  12. running can begin to control and take advantage of DESQview.
  13.  
  14.    Creating an "auto-start" macro for DESQview can allow the
  15. program to be
  16. brought up automatically on the start of DESQview.  The
  17. "auto-start" macro
  18. is described in the DESQview users' manual (page 89 in the Version
  19. 2
  20. manual).  The auto-start macro can be used to start either API or
  21. standard
  22. applications automatically when starting DESQview.
  23.  
  24.    An auto-start macro is generally a good starting method when you
  25. want to
  26. make sure your API program is run, but want to make most of the
  27. features of
  28. DESQview available to your users.  The default for starting using
  29. this
  30. method is that all of the standard menu items of DESQview are
  31. enabled. Your
  32. API program has to specifically disable menu selections after
  33. starting up
  34. if you do not want all of them available. However, sometimes API
  35. developers
  36. will want their programs to control the system more fully.  To
  37. accomplish
  38. this, you can start DESQview as follows:
  39.  
  40. DV {program information filename}
  41.  
  42. An example of a program started in this fashion is on every users
  43. DESQview
  44. disk in the SETUP.BAT file.  It reads as follows:
  45.  
  46. DV SETUP.DVP {additional parameters}
  47.  
  48.    The additional parameters listed in SETUP.BAT are specific to
  49. DESQview
  50. operation, and would not normally become a part of your API program
  51. startup
  52. (/OK assumes "non-enhanced keyboard," /NS means don't read the
  53. setup file,
  54. use defaults).
  55.    Run the DESQview Setup and you will get an idea of the defaults
  56. under
  57. which API programs started from the command line are run:
  58.  
  59.      1.  After display of the DESQview copyright screen, the 
  60.      application listed in the DVP file is automatically run.
  61.  
  62.      2.  All access to the DESQview menu is disabled.  DESQview 
  63.      macros, including the auto-start macro for the window, are 
  64.      enabled if present, but access to the Learn menu is not 
  65.      available.
  66.  
  67.      3.  Terminating the application terminates DESQview and 
  68.      drops you out to the DOS prompt.
  69.  
  70.    Obviously, the DESQview Setup program is a limited,
  71. single-tasking
  72. environment, but it demonstrates that an API program program
  73. started from
  74. the command line is firmly in control.  Once started, the API
  75. program can
  76. start additional tasks (NEW or NEWPROC in assembler, app_new or
  77. app_start
  78. in C or Pascal), and selectively enable the features of DESQview
  79. (Manager
  80. streams 00 to 3F in Assembler, or win_allow function in C or
  81. Pascal).
  82.  
  83.    The only feature which cannot be enabled is the Open Window
  84. item. When
  85. an API program is started from the command line, the DESQVIEW.DVO
  86. file,
  87. which contains the Open Window menu information, is not read into
  88. memory
  89. and the Open Window option will not be available.  Your API program
  90. could
  91. of course produce its own "front end" menu of programs to open if
  92. you like.
  93. If you want to allow users to have access to the Open Window menu,
  94. you
  95. would want to start up using the auto-start macro.
  96.  
  97.         Copyright (C) 1991 by Quarterdeck Office Systems
  98.              * * *   E N D   O F   F I L E    * * * 
  99.